home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / amok_lha / amok71.lha / XStat / XStat.dok < prev    next >
Text File  |  1993-08-15  |  11KB  |  391 lines
  1. Dokumentation zu XStat V1.03
  2. ============================
  3. Programm und Dokumentation sind © Copyright 1992 by Jürgen Weinelt.
  4.  
  5. IMPORT StdDisclaimer; (* kurz: Benutzung auf eigene Gefahr *)
  6. XStat wurde sorgfältig getestet, aber es können natürlich trotzdem noch
  7. diverse Fehler 'drinnen sein.
  8.  
  9. XStat V1.03 ist Freeware. Es darf auf nicht-kommerziellem Weg weitergegeben
  10. werden, solange die folgenden Bedingungen erfüllt sind:
  11.  
  12.   * Quelltext, ausführbare Programme und Dokumentation müssen zusammen
  13.     weitergegeben werden (XStat.mod, XStat, XStatFPU, XStat.data,
  14.     XStat.doc, XStat.dok und Make).
  15.     Die Dateien müssen unverändert weitergegeben werden!
  16.  
  17.   * PD-Serien: Die Disketten, die XStat enthalten, dürfen im deutschsprachigen
  18.     Raum nicht mehr als 8 DM kosten.
  19.     Ansonsten darf der Preis, den Fred Fish für eine einzelne seiner
  20.     AmigaLibDisks verlangt, nicht überschritten werden.
  21.  
  22.  
  23.  
  24. XStat läuft nur mit AmigaOS V36 oder höher.
  25.  
  26.  
  27.  
  28. Zusammenfassung
  29. ===============
  30. XStat wertet das Xferstat-File aus, das Andrew "Charly" Kopp's
  31. UUCiCo V1.15c (oder höher) erzeugt. Die wichtigste Information,
  32. die XStat liefert, sind die Telefonkosten für einen bestimmten
  33. Zeitraum.
  34.  
  35.  
  36.  
  37. Installation
  38. ============
  39. Die Distribution enthält zwei verschiedene ausführbare Dateien,
  40.   * XStat       (Standardversion)
  41.   * XStatFPU    (benötigt 680(2|3)0 + 6888(1|2))
  42. Kopieren Sie eines der beiden Programme an eine Stelle, die im
  43. Suchpfad enthalten ist, vorzugsweise nach UUBIN:
  44.  
  45. Außerdem muß nur noch eine weitere Datei installiert werden;
  46. sie heißt "XStat.data", und sollte am besten nach UULIB:
  47. kopiert werden.
  48.  
  49. XStat.data muß Ihren Gegebenheiten entsprechend angepaßt werden,
  50. um die Installation zu vervollständigen.
  51.  
  52.  
  53.  
  54. XStat.data
  55. ==========
  56. XStat.data enthält die Informationen über die Verbindungskosten zu jedem
  57. Host, mit dem Sie eine Verbindung unterhalten, im folgenden Format:
  58.  
  59. XStat.data Datei-Header:
  60. ------------------------
  61. H XSTAT DATA
  62.  
  63. Dieser Header muß am Anfang der ersten Zeile von XStat.data stehen.
  64.  
  65. XStat.data Kommentarzeile:
  66. --------------------------
  67. # beliebige Kommentare
  68.  
  69. Kommentarzeilen dürfen überall in der XStat.data Datei eingefügt
  70. werden, außer natürlich vor dem Datei-Header!
  71.  
  72. XStat.data Währungs-Kennzeichen:
  73. --------------------------------
  74. S <Währungskennzeichen>
  75.  
  76. Gibt das Währungskennzeichen für Ihr Land an. Dieser Eintrag muß vor der
  77. ersten "N"-Zeile stehen. Es darf höchstens eine "S"-Zeile in der
  78. XStat.data Datei geben.
  79.  
  80. Beispiele:
  81.  
  82. # Währungskennzeichen für die U.S.A.
  83. S $
  84.  
  85. # Währungskennzeichen für Deutschland:
  86. S DM
  87.  
  88. XStat.data Host-Namen-Info:
  89. ---------------------------
  90. N <Hostname>
  91.  
  92. Die "N"-Zeile kennzeichnet den Beginn eines neuen Verbindungs-Datensatzes.
  93. Mindestens eine "C"-Zeile muß folgen! <Hostname> sollte der Name
  94. einer UUCP-Site sein, mit der Sie direkt verbunden sind, ohne
  95. irgendwelche Pfad- oder Domain-Informationen.
  96.  
  97. Beispiele:
  98.  
  99. # Mein eigener Newsfeed:
  100. N imart
  101.  
  102. # Ein anderer Newsfeed:
  103. N cbmger
  104.  
  105. XStat.data Verbindungskosten-Info:
  106. ----------------------------------
  107. C <Anfangszeit> <Dauer einer Einheit> <Preis einer Einheit>
  108.  
  109. Teilt XStat mit, daß zwischen <Anfangszeit> und <Anfangszeit der
  110. nächsten C-Zeile> eine Verbindung mit dem zugehörigen Host
  111. <Preis einer Einheit> pro <Dauer einer Einheit> kostet.
  112. Die <Dauer einer Einheit> muß in Sekunden angegeben werden, der
  113. <Preis einer Einheit> in der Währung, die Sie benutzen.
  114.  
  115. Die erste "C"-Zeile muß als Anfangszeit "SU-00:00:00" haben!
  116.  
  117. Beispiel:
  118. N imart
  119. C SU-00:00:00 120 0.23
  120. C MO-08:00:00  60 0.23
  121. C MO-18:00:00 120 0.23
  122.  
  123. Von Sonntag, 0:00:00 bis Montag, 7:59:59 kostet eine Verbindung
  124. zwischen meinem Computer und dem von "imart" 23Pfg/120sec.
  125.  
  126. Von Montag, 8:00:00 bis Montag, 17:59:59 kostet eine Verbindung
  127. zwischen meinem Computer und dem von "imart" 23Pfg/60sec.
  128.  
  129. Bei diesem kurzen Beispiel würde eine Verbindung im Rest der Woche
  130. (von Montag 18:00:00 bis Samstag, 23:59:59) 23Pfg/120sec kosten.
  131.  
  132. Beispiel für eine komplette XStat.data Datei:
  133. ---------------------------------------------
  134.  
  135. - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp
  136. H XSTAT DATA
  137. #==============================================================================
  138. # XStat connection cost data file
  139. #==============================================================================
  140. #
  141. #------------------------------------------------------------------------------
  142. # currency sign for Germany; S must come before first N
  143. #------------------------------------------------------------------------------
  144. S DM
  145. #
  146. #------------------------------------------------------------------------------
  147. # my own newsfeed, connection cost is 0.23/60sec (0.23/120sec night & weekend)
  148. #------------------------------------------------------------------------------
  149. N imart
  150. C SU-00:00:00 120 0.23
  151. C MO-08:00:00  60 0.23
  152. C MO-18:00:00 120 0.23
  153. C TU-08:00:00  60 0.23
  154. C TU-18:00:00 120 0.23
  155. C WE-08:00:00  60 0.23
  156. C WE-18:00:00 120 0.23
  157. C TH-08:00:00  60 0.23
  158. C TH-18:00:00 120 0.23
  159. C FR-08:00:00  60 0.23
  160. C FR-18:00:00 120 0.23
  161. #
  162. #------------------------------------------------------------------------------
  163. # cbmger, connection cost is 0.23/21sec (0.23/42sec night & weekend)
  164. #------------------------------------------------------------------------------
  165. N cbmger
  166. C SU-00:00:00  42 0.23
  167. C MO-08:00:00  21 0.23
  168. C MO-18:00:00  42 0.23
  169. C TU-08:00:00  21 0.23
  170. C TU-18:00:00  42 0.23
  171. C WE-08:00:00  21 0.23
  172. C WE-18:00:00  42 0.23
  173. C TH-08:00:00  21 0.23
  174. C TH-18:00:00  42 0.23
  175. C FR-08:00:00  21 0.23
  176. C FR-18:00:00  42 0.23
  177. #
  178. - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp
  179.  
  180.  
  181.  
  182. Aufruf
  183. ======
  184. XStat [?|-?|-h] [-dname] [-sname] [-v] [-fdate] [-tdate] [-i] [-o] [-nname]
  185.  
  186. Sie können auch die Environment-Variable "XSTATARGS" benutzen, um
  187. Parameter an das Programm zu übergeben. Das ist besonders nützlich,
  188. wenn Sie XStat von der Workbench aus benutzen (XStat unterstützt
  189. die Workbench eigentlich nicht, daher hat es auch kein Icon).
  190.  
  191. ? | -? | -h
  192. -----------
  193. Zeigt eine Hilfsmeldung an.
  194.  
  195. -dname
  196. ------
  197. Gibt den Namen für die Verbindungskosten-Datei an. Die Voreinstellung
  198. für <name> ist "UULIB:XStat.data".
  199.  
  200. -sname
  201. ------
  202. Gibt den Namen für das Logfile an, das ausgewertet werden soll.
  203. Die Voreinstellung für <name> ist "UUSPOOL:XferStat".
  204.  
  205. -v
  206. --
  207. Steuert den "verbose"-Modus. Wenn der "verbose"-Modus eingeschaltet
  208. ist, zeigt XStat zusätzlich eine kurze Statistik für jeden Connect an.
  209. Die Voreinstellung ist "aus". Geben Sie "-v" an, um den "verbose"-
  210. Modus einzuschalten.
  211.  
  212. -fdate
  213. ------
  214. Führt dazu, daß Connects, die vor dem angegebenen Datum stattgefunden
  215. haben, ignoriert werden. Voreinstellung für <date> ist "01-JAN-78".
  216. Gültig sind alle normalen AmigaDOS Datumsangaben, insbesondere auch
  217. Angaben wie "TODAY" oder "YESTERDAY". XStat fügt intern eine Zeitangabe
  218. von "00:00:00" hinzu, die nicht manuell mit angegeben werden darf!
  219.  
  220. -tdate
  221. ------
  222. Führt dazu, daß Connects, die nach dem angegebenen Datum stattgefunden
  223. haben, ignoriert werden. Voreinstellung für <date> ist "TODAY".
  224. Gültig sind alle normalen AmigaDOS Datumsangaben, insbesondere auch
  225. Angaben wie "TODAY" oder "YESTERDAY". XStat fügt intern eine Zeitangabe
  226. von "23:59:59" hinzu, die nicht manuell mit angegeben werden darf!
  227.  
  228. -mdate
  229. ------
  230. Führt dazu, daß XStat die Parameter -f und -t ignoriert und statt dessen
  231. eine Statistik für den angegebenen Monat erzeugt. Der Monat muß im
  232. Format "MMM-JJ" angegeben werden, also ohne Tageszahl.
  233. Beispiel: -mAPR-92 erzeugt eine Statistik für den April 1992.
  234.  
  235. -i
  236. --
  237. Beeinflußt die Auswertung der eingehenden Anrufe; Voreinstellung ist
  238. "an". Geben Sie "-i" an, um die Verarbeitung eingehender Anrufe zu
  239. verhindern.
  240.  
  241. -o
  242. --
  243. Beeinflußt die Auswertung der ausgehenden Anrufe; Voreinstellung ist
  244. "an". Geben Sie "-o" an, um die Verarbeitung ausgehender Anrufe zu
  245. verhindern.
  246.  
  247. -q
  248. --
  249. Steuert den "quiet"-Modus. Beeinflußt die Ausgabe von weniger schweren
  250. Fehlermeldungen; Voreinstellung ist "aus". Geben Sie "-q" an, um
  251. die Ausgabe weniger schwerer Fehlermeldungen zu verhindern.
  252.  
  253. Der "quiet"-Modus ist besonders nützlich, um die "(ignoring this one)"-
  254. Meldungen für fehlgeschlagene Verbindungsversuche zu unterdrücken.
  255.  
  256. -nname
  257. ------
  258. Veranlaßt XStat, nur Anrufe für den Host <name> auszuwerten;
  259. Voreinstellung ist Auswertung aller Anrufe.
  260.  
  261.  
  262.  
  263. XStat's Ausgaben
  264. ================
  265.  
  266. Beispiel:
  267.  
  268. > XStat V1.03
  269. > © Copyright 1992 by Jürgen Weinelt
  270. > XStat is Freeware - read the docs for details.
  271. >
  272. >
  273. >
  274. >
  275. > Connection statistics for outgoing calls:
  276. > -----------------------------------------
  277. >
  278. > connects              53
  279. > online time        35421 sec      (     668 sec/connect)
  280. > units                323 units    (   6.094 units/connect)
  281. > cost               74.29 DM       (   1.402 DM/connect)
  282. >
  283. > brutto read      7493483 bytes    (  141386 bytes/connect)
  284. > brutto send       882109 bytes    (   16643 bytes/connect)
  285. > netto read       6526244 bytes    (  123136 bytes/connect)
  286. > netto send        132519 bytes    (    2500 bytes/connect)
  287. >
  288. > ø brutto speed       236 cps      (     243 cps peak)
  289. > ø netto speed        187 cps      (     200 cps peak)
  290. > ø brutto cost      9.301 DM/MB
  291. > ø netto cost      11.699 DM/MB
  292. >
  293. >
  294. >
  295. > Connection statistics for incoming calls:
  296. > -----------------------------------------
  297. >
  298. > no connects recorded.
  299.  
  300. connects
  301. --------
  302. Anzahl der ausgewerteten Verbindungen.
  303.  
  304. online time
  305. -----------
  306. Dauer der Online-Zeit insgesamt, und Durchschnitt pro Anruf.
  307.  
  308. units
  309. -----
  310. Verbrauchte Einheiten insgesamt, und Durchschnitt pro Anruf.
  311.  
  312. cost
  313. ----
  314. Gesamtkosten, und Durchschnitt pro Anruf.
  315.  
  316. brutto read
  317. -----------
  318. Empfangene Bytes gesamt (einschl. Protokolldaten), und Durchschnitt pro Anruf.
  319.  
  320. brutto send
  321. -----------
  322. Gesendete Bytes gesamt (einschl. Protokolldaten), und Durchschnitt pro Anruf.
  323.  
  324. netto read
  325. ----------
  326. Empfangene Bytes gesamt (ohne Protokolldaten), und Durchschnitt pro Anruf.
  327.  
  328. netto send
  329. ----------
  330. Gesendete Bytes gesamt (ohne Protokolldaten), und Durchschnitt pro Anruf.
  331.  
  332. ø brutto speed
  333. --------------
  334. Durchschnittliche Übertragungsgeschwindigkeit, einschl. Protokolldaten, sowie
  335. Geschwindigkeit des schnellsten connects.
  336.  
  337. ø netto speed
  338. -------------
  339. Durchschnittliche Übertragungsgeschwindigkeit, ohne Protokolldaten, sowie
  340. Geschwindigkeit des schnellsten connects.
  341.  
  342. ø brutto cost
  343. -------------
  344. Durchschnittliche Kosten pro MByte, einschließlich Protokolldaten.
  345.  
  346. ø netto cost
  347. ------------
  348. Durchschnittliche Kosten pro MByte, ohne Protokolldaten.
  349.  
  350.  
  351.  
  352. History
  353. =======
  354. V1.03   Monatliche Statistiken hinzugefügt.
  355. V1.02   Angabe der Spitzengeschwindigkeit (Geschw. des schnellsten
  356.         connects) hinzugefügt.
  357. V1.01   XStat produzierte einen Guru, wenn brutto oder netto nur 0 Bytes
  358.         übertragen wurden. Behoben.
  359. V1.00   Erst-Veröffentlichung :-)
  360.  
  361.  
  362.  
  363. Bekannte Probleme/Bugs
  364. ======================
  365. Bis jetzt keine...
  366.  
  367. Naja, ein Problem gibt's, aber das kann ich leider nicht ohne weiteres
  368. ändern. Die "online time" ist nicht besonders genau. Das kommt daher,
  369. daß die Anfangszeit der Verbindung ab dem Zeitpunkt gilt, zu dem das
  370. Modem "CONNECT" sagt, und das ist nicht der wirkliche Zeitpunkt der
  371. (Telefon-)Verbindung.
  372.  
  373.  
  374.  
  375. Sie können mich durch das Usenet erreichen:
  376.  
  377.    {uunet|rutgers}!cbmvax!cbmehq!cbmger!imart!hcast!jow
  378.  
  379. (Im Moment leider noch keine Domain)
  380.  
  381. Oder mit der Bundespest:
  382.  
  383.    Jürgen Weinelt
  384.    Zur Kanzel 1
  385.    D-8783 Hammelburg
  386.  
  387. Sie können auch nach comp.sys.amiga.programmer oder alt.sys.amiga.uucp posten,
  388. ich werde diese Gruppen bis auf weiteres lesen.
  389.  
  390. Viel Spass!
  391.